C++Builder의 **이벤트(Event)**는 VCL 컴포넌트에서 특정 동작이 발생했을 때 자동으로 호출되는 함수입니다. 예를 들어 버튼을 클릭하면 OnClick 이벤트가 발생합니다. 엠엠바카데로 블로그+1

자주 사용하는 C++Builder 이벤트

C++Builder의 VCL에는 이런 이벤트가 컴포넌트별로 제공되며, Object Inspector → Events 탭에서 연결할 수 있습니다. EEmbarcadero

1. OnClick 예제

TButton을 폼에 올리고 더블클릭하면 C++Builder가 이벤트 핸들러를 만들어 줍니다. 엠엠바카데로 블로그

void __fastcall TForm1::Button1Click(TObject *Sender)
{
    ShowMessage("버튼을 클릭했습니다.");
}

여기서

TObject *Sender

는 이 이벤트를 발생시킨 객체입니다.

예를 들어 여러 버튼이 같은 이벤트를 사용할 수도 있습니다.

void __fastcall TForm1::ButtonClick(TObject *Sender)
{
    TButton *Btn = dynamic_cast<TButton*>(Sender);

    if (Btn)
        ShowMessage(Btn->Caption);
}

버튼마다 별도의 이벤트 함수를 만들지 않고 하나의 함수에서 처리할 수 있습니다.

2. Form 이벤트

폼에서는 다음 이벤트가 특히 중요합니다.

OnCreate
   ↓
OnShow
   ↓
OnActivate
   ↓
OnPaint

폼이 생성되고 바로 표시되는 경우 이러한 순서로 이벤트가 발생할 수 있습니다. DDocWiki

예:

void __fastcall TForm1::FormShow(TObject *Sender)
{
    Label1->Caption = "프로그램이 시작되었습니다.";
}

OnCreate 주의

C++Builder에서는 OnCreate보다 폼 생성자를 직접 사용하는 것을 권장합니다. Embarcadero 문서에서도 C++ 코드에서는 OnCreate가 생성자와 상호작용할 수 있으므로 생성자를 override하는 방식을 권장합니다. DDocWiki

__fastcall TForm1::TForm1(TComponent* Owner)
    : TForm(Owner)
{
    // 초기화 코드
}

3. OnChange

예를 들어 TEdit의 글자가 변경될 때:

void __fastcall TForm1::Edit1Change(TObject *Sender)
{
    Label1->Caption = Edit1->Text;
}

사용자가 Edit1에 입력할 때마다 OnChange가 발생합니다.

4. 키보드 이벤트

void __fastcall TForm1::Edit1KeyDown(
    TObject *Sender,
    WORD &Key,
    TShiftState Shift)
{
    if (Key == VK_RETURN)
    {
        ShowMessage("Enter 입력");
    }
}

OnKeyDown, OnKeyUp, OnKeyPress는 각각 전달되는 인자와 용도가 조금씩 다릅니다.

5. 이벤트의 기본 구조

C++Builder VCL 이벤트는 대체로 이런 형태입니다.

void __fastcall TForm1::이벤트이름(
    TObject *Sender)
{
    // 이벤트가 발생했을 때 실행할 코드
}

하지만 이벤트 종류에 따라 매개변수가 달라집니다.

예를 들어:

// OnClick
void __fastcall TForm1::Button1Click(TObject *Sender)
{
}

// OnMouseMove
void __fastcall TForm1::FormMouseMove(
    TObject *Sender,
    TShiftState Shift,
    int X,
    int Y)
{
}

// OnKeyDown
void __fastcall TForm1::Edit1KeyDown(
    TObject *Sender,
    WORD &Key,
    TShiftState Shift)
{
}

즉, 이벤트마다 정해진 함수 형식(signature)을 맞춰야 합니다. 엠엠바카데로 블로그

원하시면 다음 단계로 `C++Builder VCL 이벤트 전체를 "이벤트 → 발생 조건 → 함수 형식 → 예제" 형태로 정리한 표도 만들어드릴 수 있습니다.